home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
u_man
/
cat3
/
Tk
/
bitmap.z
/
bitmap
Wrap
Text File
|
1998-10-30
|
7KB
|
133 lines
bbbbiiiittttmmmmaaaapppp((((3333TTTTkkkk)))) bbbbiiiittttmmmmaaaapppp((((3333TTTTkkkk))))
NNNNAAAAMMMMEEEE
bitmap - Images that display two colors
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
iiiimmmmaaaaggggeeee ccccrrrreeeeaaaatttteeee bbbbiiiittttmmmmaaaapppp ?_n_a_m_e? ?_o_p_t_i_o_n_s?
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
A bitmap is an image whose pixels can display either of two colors or be
transparent. A bitmap image is defined by four things: a background
color, a foreground color, and two bitmaps, called the _s_o_u_r_c_e and the
_m_a_s_k. Each of the bitmaps specifies 0/1 values for a rectangular array
of pixels, and the two bitmaps must have the same dimensions. For pixels
where the mask is zero, the image displays nothing, producing a
transparent effect. For other pixels, the image displays the foreground
color if the source data is one and the background color if the source
data is zero.
CCCCRRRREEEEAAAATTTTIIIINNNNGGGG BBBBIIIITTTTMMMMAAAAPPPPSSSS
Like all images, bitmaps are created using the iiiimmmmaaaaggggeeee ccccrrrreeeeaaaatttteeee command.
Bitmaps support the following _o_p_t_i_o_n_s:
----bbbbaaaacccckkkkggggrrrroooouuuunnnndddd _c_o_l_o_r
Specifies a background color for the image in any of the standard
ways accepted by Tk. If this option is set to an empty string then
the background pixels will be transparent. This affect is achieved
by using the source bitmap as the mask bitmap, ignoring any
----mmmmaaaasssskkkkddddaaaattttaaaa or ----mmmmaaaasssskkkkffffiiiilllleeee options.
----ddddaaaattttaaaa _s_t_r_i_n_g
Specifies the contents of the source bitmap as a string. The string
must adhere to X11 bitmap format (e.g., as generated by the bbbbiiiittttmmmmaaaapppp
program). If both the ----ddddaaaattttaaaa and ----ffffiiiilllleeee options are specified, the
----ddddaaaattttaaaa option takes precedence.
----ffffiiiilllleeee _n_a_m_e
_n_a_m_e gives the name of a file whose contents define the source
bitmap. The file must adhere to X11 bitmap format (e.g., as
generated by the bbbbiiiittttmmmmaaaapppp program).
----ffffoooorrrreeeeggggrrrroooouuuunnnndddd _c_o_l_o_r
Specifies a foreground color for the image in any of the standard
ways accepted by Tk.
----mmmmaaaasssskkkkddddaaaattttaaaa _s_t_r_i_n_g
Specifies the contents of the mask as a string. The string must
adhere to X11 bitmap format (e.g., as generated by the bbbbiiiittttmmmmaaaapppp
program). If both the ----mmmmaaaasssskkkkddddaaaattttaaaa and ----mmmmaaaasssskkkkffffiiiilllleeee options are
specified, the ----mmmmaaaasssskkkkddddaaaattttaaaa option takes precedence.
PPPPaaaaggggeeee 1111
bbbbiiiittttmmmmaaaapppp((((3333TTTTkkkk)))) bbbbiiiittttmmmmaaaapppp((((3333TTTTkkkk))))
----mmmmaaaasssskkkkffffiiiilllleeee _n_a_m_e
_n_a_m_e gives the name of a file whose contents define the mask. The
file must adhere to X11 bitmap format (e.g., as generated by the
bbbbiiiittttmmmmaaaapppp program).
IIIIMMMMAAAAGGGGEEEE CCCCOOOOMMMMMMMMAAAANNNNDDDD
When a bitmap image is created, Tk also creates a new command whose name
is the same as the image. This command may be used to invoke various
operations on the image. It has the following general form:
_i_m_a_g_e_N_a_m_e _o_p_t_i_o_n ?_a_r_g _a_r_g ...?
_O_p_t_i_o_n and the _a_r_gs determine the exact behavior of the command. The
following commands are possible for bitmap images:
_i_m_a_g_e_N_a_m_e ccccggggeeeetttt _o_p_t_i_o_n
Returns the current value of the configuration option given by
_o_p_t_i_o_n. _O_p_t_i_o_n may have any of the values accepted by the iiiimmmmaaaaggggeeee
ccccrrrreeeeaaaatttteeee bbbbiiiittttmmmmaaaapppp command.
_i_m_a_g_e_N_a_m_e ccccoooonnnnffffiiiigggguuuurrrreeee ?_o_p_t_i_o_n? ?_v_a_l_u_e _o_p_t_i_o_n _v_a_l_u_e ...?
Query or modify the configuration options for the image. If no
_o_p_t_i_o_n is specified, returns a list describing all of the available
options for _i_m_a_g_e_N_a_m_e (see TTTTkkkk____CCCCoooonnnnffffiiiigggguuuurrrreeeeIIIInnnnffffoooo for information on the
format of this list). If _o_p_t_i_o_n is specified with no _v_a_l_u_e, then
the command returns a list describing the one named option (this
list will be identical to the corresponding sublist of the value
returned if no _o_p_t_i_o_n is specified). If one or more _o_p_t_i_o_n-_v_a_l_u_e
pairs are specified, then the command modifies the given option(s)
to have the given value(s); in this case the command returns an
empty string. _O_p_t_i_o_n may have any of the values accepted by the
iiiimmmmaaaaggggeeee ccccrrrreeeeaaaatttteeee bbbbiiiittttmmmmaaaapppp command.
KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
bitmap, image
PPPPaaaaggggeeee 2222